Skip to content

docs: add api reference section - #716

Open
kacperzolkiewski wants to merge 43 commits into
feat/docsfrom
@kacperzolkiewski/docs-api-reference
Open

docs: add api reference section#716
kacperzolkiewski wants to merge 43 commits into
feat/docsfrom
@kacperzolkiewski/docs-api-reference

Conversation

@kacperzolkiewski

Copy link
Copy Markdown
Collaborator

Summary

Add Api reference section to docs

hejsztynx and others added 13 commits July 16, 2026 12:22
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Kacper Żółkiewski <74975508+kacperzolkiewski@users.noreply.github.com>
Co-authored-by: Kacper Żółkiewski <74975508+kacperzolkiewski@users.noreply.github.com>
Co-authored-by: Kacper Żółkiewski <74975508+kacperzolkiewski@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds full API reference documentation pages for the library’s two main public components (EnrichedTextInput editor and EnrichedText renderer), replacing prior TODO placeholders.

Changes:

  • Documented EnrichedText props, types, remarks, and platform compatibility.
  • Added a comprehensive EnrichedTextInput API reference including props, ref methods, and style/type definitions.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/docs/api-reference/enriched-text.md Adds EnrichedText API reference with prop documentation and related types.
docs/docs/api-reference/enriched-text-input.md Adds EnrichedTextInput API reference covering props, ref methods, and styling/type details.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/docs/api-reference/enriched-text.md
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
kacperzolkiewski and others added 2 commits July 21, 2026 11:52
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md
kacperzolkiewski and others added 8 commits July 21, 2026 14:28
Co-authored-by: Krystian Sienkiewicz <146986839+hejsztynx@users.noreply.github.com>
Co-authored-by: Krystian Sienkiewicz <146986839+hejsztynx@users.noreply.github.com>
Co-authored-by: Krystian Sienkiewicz <146986839+hejsztynx@users.noreply.github.com>
Co-authored-by: Krystian Sienkiewicz <146986839+hejsztynx@users.noreply.github.com>
Co-authored-by: Krystian Sienkiewicz <146986839+hejsztynx@users.noreply.github.com>
Co-authored-by: Krystian Sienkiewicz <146986839+hejsztynx@users.noreply.github.com>
Co-authored-by: Krystian Sienkiewicz <146986839+hejsztynx@users.noreply.github.com>
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Comment thread docs/docs/api-reference/enriched-text-input.md Outdated
Base automatically changed from @ksienkiewicz/docs-fundamentals to feat/docs August 11, 2026 10:24

@exploIF exploIF left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔥 🔥 🔥


| Type | Default | Platforms |
| ------------------- | ------- | ------------ |
| `ContextMenuItem[]` | - | Android, iOS |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a general note, but let's remove Default column for callback, there is no option to have a default callback implemented


```ts
interface OnChangeStateEvent {
bold: { isActive: boolean; isConflicting: boolean; isBlocking: boolean };

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we make it more readable? I think it makes sense to extract { isActive: boolean; isConflicting: boolean; isBlocking: boolean } to a separate interface and reuse it whenever possible. Currently it's hard to see difference between styles

Comment on lines +398 to +403
:::tip

If you don't need the plain text value, omit `onChangeText` - continuous text
extraction can have performance implications.

:::

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's remove it. It's true for html, but impact when using raw text should be minimal, not worth mentioning it imo

| ----------------------------------------------------------- | ------- | ----------------- |
| `(event: NativeSyntheticEvent<OnPasteImagesEvent>) => void` | - | Android, iOS, Web |

:::tip

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's make it note instead

- For the full list of supported tags and style conflicts, see
[HTML format and supported tags](/fundamentals/html-format-and-supported-tags).

## Platform compatibility

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we can remove it


## Props

All props are optional except `children`, which is required.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
All props are optional except `children`, which is required.
All props are optional except `children`.

except already desires that this one is required ;)


| Type | Default | Platforms |
| -------- | ------- | ------------ |
| `number` | `0` | Android, iOS |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really default is 0? It sounds weird to me, isn't it undefined?


- `EnrichedText` is read-only. Use [`EnrichedTextInput`](/api-reference/enriched-text-input)
when the user needs to edit content.
- Pass the HTML string as `children`, not as a `value` prop.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Pass the HTML string as `children`, not as a `value` prop.

I think It's redundant

Comment on lines +268 to +271

## Platform compatibility

<PlatformCompatibility android ios web />

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's not needed

Suggested change
## Platform compatibility
<PlatformCompatibility android ios web />

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants